Hermes Agent 源码架构详解

hermes-agent/
├── hermes_cli/          # CLI 主入口（argparse 命令体系）
├── agent/               # AI Agent 核心引擎
├── gateway/             # 消息网关（平台适配层）
├── tui_gateway/         # TUI JSON-RPC 后端
├── acp_adapter/         # ACP 编辑器协议适配器
├── environments/        # RL 训练环境 / Benchmark
├── plugins/             # 插件体系（记忆/图像/平台）
├── skills/              # 内置 Skill 库
├── optional-skills/     # 可选 Skill（区块链/健康/研究等）
├── web/                 # Web 前端（TypeScript React）
├── website/             # 官方文档站（Docusaurus）
├── scripts/             # 工具脚本
├── cron/                # Cron 调度
├── docs/                # 开发文档
├── docker/              # Docker 配置
└── packaging/           # 打包配置（Homebrew 等）

                         ┌─────────────────────────────┐
                         │         用户输入             │
                         │  (CLI / Gateway / ACP / TUI) │
                         └──────────────┬──────────────┘
                                        │
                    ┌───────────────────┼───────────────────┐
                    ↓                   ↓                   ↓
             ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
             │ hermes_cli/  │  │  gateway/    │  │ acp_adapter/ │
             │  commands.py │  │   run.py     │  │  server.py   │
             │  (slash cmds)│  │ (平台适配中枢) │  │  (编辑器协议) │
             └──────┬───────┘  └──────┬───────┘  └──────┬───────┘
                    │                 │                 │
                    └────────┬────────┴────────┬────────┘
                             ↓                ↓
                    ┌──────────────────────────────┐
                    │        agent/run_agent.py      │
                    │      AIAgent 主循环（核心引擎）  │
                    └──────────────────────────────┘
                             │
         ┌───────────────────┼───────────────────┐
         ↓                   ↓                   ↓
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ prompt_builder   │ │ curator.py       │ │ memory_manager   │
│ 构建完整prompt    │ │ 上下文策展/压缩   │ │ 记忆provider管理  │
│ (最大文件31.6KB) │ │                 │ │                 │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
         │                   │                   │
         │          ┌────────┴────────┐          │
         │          ↓                 ↓          │
         │ ┌────────────────┐  ┌──────────────┐ │
         │ │context_compressor│  │context_engine│ │
         │ │ (默认压缩实现)   │  │ (抽象基类接口) │ │
         │ └────────────────┘  └──────────────┘ │
         │                                     │
         └──────────────┬──────────────────────┘
                        ↓
          ┌───────────────────────────────┐
          │     agent/run_agent.py         │
          │   API请求 → 工具分发 → 响应    │
          └───────────────────────────────┘
                        │
         ┌──────────────┼──────────────┐
         ↓              ↓              ↓
  ┌────────────┐ ┌────────────┐ ┌────────────┐
  │Bedrock适配器│ │Gemini适配器 │ │ models_dev │
  │            │ │            │ │ (模型元数据) │
  └────────────┘ └────────────┘ └────────────┘

main.py → cli.py → run_agent.py → 返回终端
         ↑
    commands.py（slash命令定义COMMAND_REGISTRY）

gateway/run.py（总调度）
    ├── session.py（会话上下文）
    ├── platform_registry.py（平台注册表）
    ├── delivery.py（输出路由）
    └── platforms/{telegram,wechat,wecom,...}.py（各平台适配器）

curator.py（策展人）
    ├── should_compress() → 判断何时压缩
    └── compress() → 调用 context_compressor
                      └── context_compressor.py（默认实现）
                          └── context_engine.py（抽象基类，可插拔）

run_agent.py（收到LLM的tool_calls）
    ↓
display.py（预览工具调用）
    ↓
工具执行（terminal/read_file/...]
    ↓
tool_guardrails.py（循环检测）
    ↓
结果返回 run_agent.py → 继续下一轮

models_dev.py（模型元数据中央）
    ↓
┌──────────────────────────────────────┐
│  bedrock_adapter.py  → AWS Bedrock   │
│  gemini_native_adapter.py → Google   │
│  moonshot_schema.py  → Moonshot     │
│  （各自转换 OpenAI格式 ↔ 各家格式）   │
└──────────────────────────────────────┘
    ↓
统一经过 error_classifier.py 做错误分类和重试策略
    ↓
nous_rate_guard.py（速率限制保护）

run_agent.py
    ↓
memory_manager.py ───→ plugins/memory/{mem0,holographic,honcho,...}.py
image_gen_provider.py ──→ plugins/image_gen/{openai,xai,...}.py
shell_hooks.py ──→ 用户自定义 shell 脚本钩子

（均通过抽象基类接口注册，可热插拔）